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I. INTRODUCTIQN 


This thesis is the design and implementation of a user 
interface for a color, raster=scan display device, specifi- 
cally the RAMTEK Gxel00A,. The basic desian and operation of 
the device as imolemented in the Naval Postgraduate School 
Computer Laboratory is discussed. 

The actual design and aoe of the interface 15 
oresented as well as the oroblems which were considered in 
macmaesiom and construction. The main consideration in the 
design of the interface was how to effectively imolement the 
meemor color in @ graphic disolay. 

iemEcomeeot of a color triole and color cube are intro=- 
duced as natural extensions of the method used by color 
Graphics devices. However, the triple and cube are eee 
defined by eens in the hardware that restrict the 
number of colors that can be generated to 4096. 

A user's manual was written to enable the user to util- 
ize the interface from a proaqram written in the high level 


language, C [lls supported by the UNIX operating system on 


the PDP=-11/50. feeis tmeluded im Sopendix A. 





PieeeoeniGrAL DESCRIPTION OF RASTER SCAN DEVICES 


The cathode ray tube is the most widely used graphics 
Smesplay cdevice today. It consists basically of an electron 
gun which projects a beam of electrons onto a screen which 
has a phosohor coating. The phosohor is excited when struck 
by the beam of electrons and emits visible light which is 
perceived by the viewer. Oue to the short persistence of 
the ohosphor utilized on most cathode ray tubes, jt 1s 
necessary to repeatedly excite it to minimize fading of the 
image and reduce visible flicker. There are two basic 
methods used to refresh a display. The first is to directly 
trace the image beina oroduced several times a second with 
the electron beam turned on. The second is to scan the 
entire screen with the beamr while only turning the beam on 
aa of f when desired to oroduce the image. The second 0s 
known aS the raster scan technique. I[t is the same tech- 
nique used in commercial television sets. 

In raster scan devices, the screen is divided into lines 
and elements. Lines extend horizontally across the screen 
and elements are discrete positions on a line. A specific 
element on a sopecific line is called ae opixel. Figure 1 
illustrates the relationship of lines, pixels and elements 
to each other and the screen. The number of oixels deter- 
mines the resolution of the screen. The more pixelsr the 


pone retne FEeSolution of the picture. 
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Line, Element, Pixel Relationshio 


Pour e. 11 


inemeacced.) feature of color im a raster scan device re- 
Quires the addition of two more electron guns ‘and a more 
complicated phosphor coating on the screen. The phosohors, 
reoresenting the orimary colors of blue, green and red are 
located in each oixel area and are called a triad. The 
three guns are used to produce three electron deams to scan 
the screen. These beams are indeoendently varied in intensi- 
ty to excite any one, two or three ohosohors to produce the 
desired color. 

In order for an image to be drawn in colors, mot. only 
must the electron guns be turned on and off at the orooer 
locations, out the combination of deams and the intensity of 


be 





each must be adjusted to eproduce the color. 


Pitt e ite eraMlek Cx=-100A GRAPHITES DISPLAY 


The RAMTEK is an interactive, raster=Scan, color graph- 
1cs display device. It consists of a bisdirectional inter- 
face, a display generator, solid state memory, a video look- 
up table, device multiplexor, keyboard, cursor generator, 
video generator, ama a Gatnocge Tray tuoe (ela Fiquee 2941 -= 
lustrates the relationship of the hardware and the component 


parts’ relationshios with each other. 


Ae SI“DIRECTIONAL [INTERFACE 

The bisdirectional wmtertacemcommects the POP=la with 
the video lookus tabler display generator and the device 
multiplexor. The interface establishes data paths to and 
from the CPU and the device multiplexor, ee video lookup 


table, and the display generator. 


BRO EVICE MULTIPLEXOR 

The device multioclexor inmtercomnectsS with the cursor 
generator and the keyboard. It enables the CPU to receive 
data via the RAMTEK keyboard. 

The keyboard converts the keystrokes into extended ASCII 
character codes which are transmitted to the device multi 


olexor. 
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RAMTEK Hardware Configuration 
Figure 2 


13 





Pee DLiSPLAY GENERATOR 

The display generator contains the standard ASCII char- 
geter codes and hardware logic such that dot=matrix charac 
her patterns are generated and passed to the memory. It 
eimsco takes input data and processes it according to the 
instructions receiveco and writes the appropriate data into 


the memory so the proper image will be displayed. 


Pa MEMORY 

The organization of the solid state refresh memory is 
the kev to the operation of the RAMTEK., The memory consists 
of up to eight memory boards (planes) which have the capaci= 
ty to store 5le lines by 640 elements. The RAMTEK used in 
this work has four memory dlanes and an effective address 
space of 240 lines oy 640 elements. 

As illustrated by figure 3, the memory can be viewed as 
a three dimensional structure with the x*axis corresponding 
to the elements, the ytaxis corresodondina to the lines and 
the z7axis corresponding to the display subchannels. 

The display subchannels reoresent a binary pointer into 
the video lookup table by only oermitting certain planes of 
memory to be written in. Thus the binary code on a certain 
z-axis represents the pointer into the video lookup table. 
This establishes the color to be disolayed at that location 
on the screen. For example, if the z*axis at line five, 
euememtmmececomtains a JUlLOl, the pointer into the video look= 


up table points to entry five. 
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Memory Confiagurati.on 


Pi ouren. 


Ee. VIDEO GENERATOR 
The video generator reads the infcrmation stored in the 
refresh memory and generates the comoatadle signals for the 


Cathode ray tube (CRI) to disolay the image on the screen. 


pee viOEO LOOKUP TABLE 

iinemyidecumlookue table is the center of the color gen= 
pecmimcmcacaoility of the RAMTEK, It contains sixteen arbis 
trary colors from address zero to fifteen in tne table. As 
described abdover the combination of memory olanes enabled 
by the selected subchannels reoresents the pointer to an 


entry in the video lookuo table. Each entry im the video 


iS 





lookup table consists of a twelve=bit code broken into three 
four=bit binary fractions which correspond to intensities 
of blue, green and red. As illustrated in figure 4, bits 
zero fmirough three represent red, roOuG thiroudn seven 
represent green and eight through eleven represent blue. 
Therefore, any of 4096 colors can be represented in the 
twelve bits. Oniy sixteen colors can be displayed on the 
screen at any one time because having four planes of memory 
to) 60represent)6= 6the)6pointer to the video lookup table limits 


the pointer value to zero through fifteen. 


<DVAaMm 





Video Lookup Table 


Figure 4 
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IV. POSITIONAL ADDRESSING 


There are three methods of addressina the RAMTEK screen; 
absolute, indexed and relative. As stated earlier, address- 
ing a raster scan device is accomplished by specifing the 
line and element number which indicate the address of a 
pixel on the screen. 

Because of the low line resolution of the device used, 
only even lines are aadressable. Therefore the line ad- 
dressing 18S from zero to 480 where zero and one address the 
Same line, two and three address the same line and $0 on. 
The address that 18 currently being referred to is known as 
@eoeecurrent operating coint (GOP). Tt 18s like a oointer to 
a location on the screen where the next entity will] be 


displayed. 


A. ABSOLUTE ADDRESSING 
By specifying a line and element number, a single pixel 
1S addressed in the same way as a point 18 addressed 1n a 


cartesian coordinate system. Tiermeur wis ot that o1xel. 


8. INDEXED ADDRESSING 

The RAMTEK provides two index registers which can be 
used in addressing the RAMTEK screen. To address a location 
USINQ index registers, the specified line and element 
numbers are summed with the contents of the line and element 
index registers to yield the address of a oixel on the 
screen. For examole, if the soecified address is line 100, 
element 200 and the line and element index registers contain 
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26 and 30 respectively, the resulting address (COP) is line 


126, element 1350. 


fee ELATIVE ADDRESSING 

This method takes the specified line and element numbers 
and considers them to be displacements, that 1S, the number 
of lines and elements to add to the COP address to yield a 
new COP. For example, if the specified displacements are 20 
lines and 30 elements, and the COP is line 100, element 140; 


mnemmew COP is tine 120, element 170. 


Veen CO Ni Ol MODES 


The RAMTEK operatesS in any one of eight control modes 
eee Cach control mocge can be modified by selected control 
flags. The modes and their applicable control flags are 
summarized in Tables I and II. More detailed descriptions 


of the modes and how they work are located in Apoendix A. 
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CONTROL 


Mode 


Alohanumeric Data 


Transverse Data 
Raster Data 
Comolex Data 
Graphic Vector 
Graphic Plot 
Graphic Cartesian 


Graphic Element 


PAGE E a7 


MODE NOEFINTD IONS 


Functional 


Writes alohanumeric 
on the screen, 


Vesemioti1on 


characters 


Decodes tne data as a single bit 


oer pixel 
an eight 
column 


pixel wide 


Transverse 
bert. ton f1agnit) on 


Same as 
writes 
line. 


Decodes the 
bItCS | per .o0) xe! 
to right on the same 


rawsceGomt 1 mucous 
arbitrary end points. 


Draws 
drawing continuous 
successive yraxis 
incrementing the 
iperiet sition mr tot. 


Xx"3x1S 


Draws solid 


data 
the 


data as 
and writes 
lotune. 


rectangles 
tween arbitrary end points. 


and writes the data in 
vertical 
Veo tomo. bot tom. 


Out 
same 


four 
eo hat 


lines between 


a histogram style plot by 
lines between 
points while 


from 


be= 


Draws a dot at specified point. 


le 
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CONTROL FLAG DEFINITIONS 


Name Functional Descrisction 
Index Addressing Causes indexed addressing to be 
in effect. 


Reverse Background Causes ones written in memory to 
become 2eros and vice-versa. 


Additive Write Causes the new image to written 
MOMeeGe, Gfethe ex isitima simecge « 


Double Width Doubles the width of aqenerated 
data by writing each bit of data 
into two elements instead of 
one. 

Fixed Point Uses the point defined by the 
contents of the line and element 


index registers as the Starting 
point for wach granhic entity. 


Vinee oe ec DAE EUNCTLONS 


There are two soecial functions which alter the display. 
The first is the erase instruction and the second 1s the 
aGro} | Tinie t 1 Om « 

The erase function simoly writes al] zeros or ones into 
memory depending on the state of the background flag tn the 
control mode and the subchannels selected. 

ing etal) it function creates a moving window effect by 
moving the image vertically for a specified number of lines. 
A positive or negative number indicates which direction the 
image will move. Images that are scrollea off the top of 
the screen rerenter the bottom and vice-versa. 


2) 





VII. GENERAL USER INTERFACE DESIGN 


One of the governing constraints in developing software 
for graphics output is the fac petit 1 € is nar Cen co 
describe a picture than it is to describe a table of words 
on numoers. 

For this reason, some of the normal orinciples of good 
system design apoly with exceptional force. The user who 
mao the jod of describing a picture must be provided with a 
set of instructions and graohic tools that enable him to 
concentrate on the tmaqe he wishes to create. The user must 
not be distracted by irritating details imposed by the 
peculiarities of the hardware. He must be allowed to ex 
press algorithims as he conceives them, and be able to trace 
mm@mcorrect errors with a minimum of trouble. I[t ie essen- 
tial that the graphics system be simole to oroagram (3). 

An excellent general aporoach to designing a user inter- 
face for graphics systems is expressed by Waaner and LaHood 
pee It describes some general guidelines in which a level 


Smuecture 1S built. 


Pee ULI ILEVEL STRUCTURE 

A multilevel design is based on building blocks which, 
at the lower levels, involve efforts to provide an efficient 
interface between the computer ang the graphic device. 
Higher levels of software are then developed to increase the 
Smoductivity of the total system. Routines on the lower 
levels are dependent on hardware, but as levels increase, 


the deoendence on haraware decreases, and the complexity ela 
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the functions performed by software increases. At the 
highest level the routines are totally independent of 
hardware. 
1. Level I = Primitive Hardware Oriented Subroutines 
Level I routines are intimately concerned with the 
hardware characteristics of the device. These form the 
basis for building Level II routines. Examples are primitive 
display command utilities, display instruction assembler, 
mcerrupt handling routines, and device controllers. 
e. Level II = Complex Information Handling Subroutines 
Level II routines combine the facilities of the 
operatina system with the hardware oriented routines of Lev- 
e | I to orovide the programs and user oriented lanquages 
to oe used at Level We iceies Examoles are file management, 
buffer management utilities, and utilities that convert user 
defined coordinate systems to a device deoendent coordinate 
System. 
3. Level III = Generalized User Oriented Subroutines 
Level Piteeeroutimes have the abdility to perform 
several Level II routines to accomolish a single task. The 
Boucines sallow specification of disolay functions through 
device indeoendent oarameters. They are called within a 
procedural iaincauacemmmnrkKemrGm ll) 7) Algol or Fortran.  Jhere=- 
fore, they add to the canvabilities of an existing implemen- 
mation. Examoles are plot routines, automatic scaling, 
print and label routines. 
G. Level IV = Anplication Lanaquaae Processors 


Leve!l IV programming supoort 1S directed at the user 


ae 





who 31S not a orogrammer. It is intended to make him less 
dependent on programming by simplifying the task of specifys= 
aa Graphic output. Once implemented by using routines in 
Levels I, II and III, and other programming techniques, user 
languages provide access to the graphic device and increase 
its usefulness. Examoles of some Level IV uSersoriented, 
high level language systems are MIT Sketch Pad (4], Bell 


Animation Language [5,6] and GM Design Analysis System (7). 


Perl. SUSER INTERFACE DESIGN FOR THE RAMTEK GX=-1004 


A. GENERAL 

In the design of a user interface for a color graphics 
device a primary consideration is to make the use of color 
as easy for the user as possible. The user should be per- 
mitted to make up colors at the device and be given a simple 
method of selecting the colors desired in the anpolication 
Program. The user should be allowed to nodify the colors at 
meri e1ther§6 6 douUrFINg Program execution or by a pre~execution 
Selection orocess. The user Should be relieved of select= 
ing the exact bit patterns needed to eroduce the color on 
the screen. Elimination of device dependent programming 
Pmrows the user to think of color as it applies to a orob- 
lem. 

It is necessary to isolate the user from the low-level 
assembly languages to allow concentration on the probdlem and 
not have to worry about when and how to issue the oroper 
hardware instructions to the display device. A user should 
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Bempavle to think in terms of a virtual screen space of his 
own definition and not be concerned with hardware address> 
ao. 

When a user interface is designed, it should be easily 
integrable with the host computer lanquadade. The easiest way 
to accomplish this jis to use subroutine calls from the user 
program. The calls should be keot as simole to use as prac- 
ticable. Toward this end, the number of parameters involved 
should be keot to 2 minimum. 

The user should be protected from abnormal termination 
as much as possible by the interface. As an example, the 
interfacing routines can check the passed oOarameters to 
ensure that they are correct. They should indicate errors 
and what they are to simolify debugging. Graphic tools 
erovi1ded to the user should encourage concise, clear’ pro 
gramming. 

The overall princioles and methods of level design as 
discussed earlier were followed in implementing the intere 
face for the RAMTEK. Since Level I routines were essential= 
ly comolete or were hardware implemented, the resulting 
design took place more in the Level II and Level III areas. 
It was decided to implement the interface as a set of 
subroutine calls from the C [1] programming language because 
C ig the primary language on the HoOsemcompuLer and because 
of 1ts simple subroutine calling format. 

As a first step, a set of primitives were designed to 


form the basis for other routines to build on. 
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lee Primitive Functions 

The primitive functions make uo the majority of the 
level II and level ITI routines. The criteria followed in 
choosing the orimitive functions were claritys convenience, 
and compactness. Clarity means primitives are to perform 
@emey, one function and that function must be clear and sim- 
ple. 

Due to the hardware caoabilites of the RAMTEK, 
several primitives became user routines on Level III as wel] 
as being primitives. The construction of a set of primieg 
tives condensed the entire cavability of tne RAMTEK hardware 
memercions to 21 instructioms or subroutines. The primitives 
which are apolicable to user orograms are described in 


Appendix 6. 


Same APPLICATION OF COLOR 

After the design of the primitive set, it was necessary 
to design a method by which the user would be able to easily 
utilize and understand how to get color into a disolay and 
Gomtrol or modify it. Two key concepts were used. The 
first was extended from an actual hardware feature. It was 
the video lookup tadle concept translated into a color 
table. The available colors can be thought of as a book of 
colors from which the user can choose the oage he wishes to 
use. The page corresponds to the color table. 4)] the user 
meeds to do is select the page (color table) and color 
Centry) desired and then draw the entities using that color. 
The concept works well, but a oroblem arose as to how to 
present the information to the user so it iS understandable 
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and useable. Humans have the characteristic of not all pere 
ceiving the same color the same way. A shade of blue to one 
person, may not be the same to another. And of courses some 
humans have varyina degrees of coloreblindness. Also, 
reoroaduction of color tn manuals and photographs may not be 
accurate representations of the color the RAMTEK displays on 
its CRT. As a result of these considerations, it was decid- 
ed that an interactive orogram should be designed and ime- 
plementated itnto a subroutine cal] to allow the user to 
examine and work with the colors while actually viewing them 
on the RAMTEK screen. 
1. Interactive Program 

The interactive subroutine'’s purpose 1s to allow the 
user to see and modify color tables while seated at the 
RAMTEK keyboard. It embodies several features. 

a. oelf=tutorial , 

As the user utilizes the routine, instructions 
are given at each step as to how to orogress through the 
various editing modes. 

b. Color Table Display 

The page representing a soecific color table is 
Gesigned so the user sees the fifteen colors in three modes, 
mena block of Color, a line of color and alohanumeric 
Characters of the color are disolayed. The display thereby 
Shows the different apoearance color can take on when 
displayed in different shaoes. 

ce Multiple Edit Modes 


The routine orovides five methoas of editing and 
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mea tying color tables and their entries. This gives maxe 
imum flexibility to the novice as well as the more advanced 
user. The use of the interactive routine iS explained in 
detail in Appendix A. 
eee color Cube 

The color cube transforms the video lookup table 
moa third dimension to further aid in communicating to 
momen user how to construct colors and: how they relate to each 
eemer. itlthe concept of the color cube, as illustrated in 
megure So, describes the 4096 colors that can be created by 
defining the colors as ordered triples as’ follows: (0,0,0) 
to (0-,0,15) reoresent shades of red, (0,0,0) to (0-15,0) 
reoresent shades of green and (0,0,0) to (15-0,0) reoresent 
shades of blue. By a careful inverting and combining of the 


three axis» many of the 4096 colors can be created. 


See viRTUAL DISPLAY SCREEN 

Simemot tne important considerations of a successful user 
interface was met by writing a routine to allow the user to 
define the address space of the screen. The user defines 
the virtual screen bv giving floating ooint cartesian coors 
dinates representing the lower left and upper right corners 
of the screen. The interface remembers his declaration and, 
until the user changes the virtual screen, all addresses are 
transformed from the virtual coordinates given into real 
screen coordinates. The process is completely transparent 
to the user. To further aid the viewer, an axis system, 
centered where desired, can be disolayed on the screen. 

If the user chooses not to declare a virtual screen, the 


aa. 





green 





(0,0,15) 


Eoloe Cube 


FVWoure~ > 
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interface defaults to an 100 oy 100 unit screen. This iso- 
lates the user from real screen addressing problems. 

All virtual screen displacements are also scaled _ into 
real screen displacements, thereby giving the user total 
freedom to define the virtual screen as long as a standard 


cartesian coordinate system is used. 


ff 


D. HIGH LEVEL GRAPHIC TOOLS 

A set of level III araphic tools was also designed, and 
its use and descriotion is detailed in Appendix A. Here 
Simplicity, usablity and understandablity were the driving 
factors in the design. When O0ossible, the user never has to 
9aSS more than four parameters. The hiaqher level tools are 
logical operations that require the programmer to remember 
as little as possible when utilized. 

All high level tools which draw oraphics figures scissor 
[8] the image by permitting only the portion of the image 
mate falis in the virtual Screen to be displayed. 

All FOUL Mes returm an Iandication if an error has oc= 
cured or an incorrect parameter has been passed, thereby 


providing a debuaaging capability to the user. 


pee ENPUT AND OUTPUT ROUTINES 

Three subroutine calls were developed to provide the 
user with an interactive input/output capaodility. The first 
is used by the user to retrieve single ASCII character codes 
from the RAMTEK keyboara. The second is used by the user to 
return an octal or decimal number from the RAMTEK keyboard. 


Meme nire 15 Used to return a floating ooint number to tne 
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user from the RAMTEK keyboard. These routines provide a 


powerful tool to the user in programming. 


F. MAINTAINABILITY 

The functional design and level StruUctURIMG. Serve t0 
make servicing the interface an easy task. When a specific 
function does not perform as expected, the portion of the 
interface which applies to that function is easy to find and 
isolate for testing and debuqging. Most of the interface 
routines do error checking and selfedocumentation when an 


SmrOor OCCUFS. 


TX. RECOMMENDATIONS 


Pee eoeR INTERFACE ADDITIONS 

The following modifications to the user interface are 
recommended. The design and imolementation of a comolement- 
Broeecata structure to hold and control] display entities for 
transfer to and from the RAMTEK on user command would be an 
excellent and ovowerful addition to the present interface. 
The data structure could utilize the existing routines with 
few changes. Such an addition would aid the user by allow 
ing selective display and erasure of user entities with a 
Single command. 

Also, further interfacing of the RAMTEK keyboard to prose 
vide cursor control and readback of virtual or real screen 
coordinates from its location would be extremely useful. 
several of the unused keys could be turned into function= 
type switches as wel). 
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See UOTLTION OF HIGH LEVEL USER ROUTINES 

More routines to give the RAMTEK 2 Sivinamic cm cendcs 
capability 1s oossible, but limited by the raster rate and 
data transfer rate. Move routines and selective erasure of 
entities can be accomolished within the confines of a well 


defined data structure. 


oe COuGe Uo LONS 


The user interface as desiaqned and imolemented 1S work-= 
ing with no known software buas. The entire range of 
hardware capabilities of the RAMTEK have oeen successfully 
incorporated and tested. Several successful high level 
routines, most notably the plotting routines, demonstrate a 
high degree of usefulness and are indicative of the capadil- 
ities that a color device in conjuction with an adequate 


software interface has to offer. 
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APPENDIX As USER MANUAL 
eel TR OUUC TION 


The RAMTEK GxX-100A its a color, raster scan display dev- 
Meer the heart of which 1s a color cathode ray tube not 
unlike a home color television set. im. tacts tts. raster 
scan method for generating a picture 1s identical to commere 
cial cathode ray tubes. At this point the similarity ends. 
Instead of decoding siaqnals transmitted by a television 
broadcast station, the RAMTEK gets the information 1O RTs 126s 
picture from a special video generator which reads the con- 
tents of a MOS refresh memory which contains all the infore 
mation needed to produce an image on the screen. It 15 not 
within the scope of this manual to go into the details of 
how the electronics functions, but to acum the user on how 
to use the device to aisolay the desired image. 

A borief descrivtion of the parts of the RAMTEK will be 
Given followed by a discussion of its various daisplay modes. 
Next a discussion of how the user can define and utilize 
colors will be presented. 

iiemmusemes'S cdlso cdirected to Sopendix 8B for information 
on how the user routines implemented in the interface are 
used and what their functions are. Periodically small se- 
quences of C code will be listed. These bits of code are 
not intended to run without the necessary C and user inter- 
face routines that must orecede them. They are ocresented to 


demonstrate how certain instructions are utilized. 
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emeener reAMTEK DESPLAY SYSTEM 


A more detailed discussion of the functioning of the 
RAMTEK can be found in the RAMTEK GxX-100A 9] and RAMTEK 


GxX-1008 [2] programmers manuals. 


A. GENERAL 
[mes RAMIEK C€onsistsS of a software interface to the user, 
a display generator, keyboard, video lookup table and a 


memmode ray tube. fheir relationshion is illustrated in fig- 


ure Awl, 
User Display 
Program Generator 





ona anya Ot D me 


Keyboard 


User Interface, RAMTEK Relationship 


Figure Aq-li 


The user program executes on the PDP-11/50. When the 
appropriate instruction 18 executed, the interface between 
the program and the display generator for the RAMTEK 1S 


activated. Information can be sent via the interface to the 
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Mrsolay generator from the user program or the keyboard. 
Information can also be sent from the keyboard via the in- 
terface to the user program. After the display generator 
mereerorets its instructions and constructs the display in 
its RQM memory, the image is generated on the CRT according 
to the colors contained in the video lookup table. Any 
image wil] remainr unless overewritten, for an indefinite 
period of time in the ROM memory. 

The keyboard is interfaced to the user program and to 
the instruction display generator. Information can be 
passed from the keyboard in the form of ASCII character 
codes to the user program or to the disnlay generator and 
Mepeely to the CRT screen. The keyboard also contains eight 
mide t1on switches to COpunCimmGmMe waGti1on Of @ CUrFSOF Which 15 
displayed on the screen. The address of the cursor on the 
screen iS always available to the user program via the ine 
terface. 

The video lookuon table contains the coded information 
which is used in generating color. The table is available 
via the interface to the user orogram. By modifying the 
contents of the tabler various colors can be displayed on 
the screen. 

The RAMTEK ograodhics display in the Naval Postgraduate 
School Computer Laboratory utilizes a raster scan cathode 
ray tube with a screen resolution of 240 horizontal lines 
and 640 elements on each line. A specific element and line 
is referred to as a oixel. This device has a high element 


resolution and a low line resolution. Therefore, the 
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quality of some images on the RAMTEK can be rather poor. 
Lines that are not horizontal or vertical are drawn with a 
noncontinuous, staircase effect. When utilizing the device 
these resolution factors should be kept in mind especially 
when operating in a data mode. Addressing the CRI screen is 
discussed in the section on Virtual Screen Addressing. 

Color is generatea by mixing three primary colors; blue, 
apie n and red in varying intensities. Using color is dis- 


cussed ina later section. 


eae VIRTUAL SCREEN ADDRESSING 

The initialization of the RAMTEK, which is accomolisned 
by the instruction ramtek(), presets the virtual screen to a 
Standard cartesian coordinate address soace with (0.0,0.0) 
as the lower Jeft corner of the screen and (100.0,100.0) as 
Bae, upoer right corner. The virtual screen can be redefined 
@yeerssuing a screen(x-,y,xlryl) instruction. 

screen() redefines the virtual screen by setting the 
lower left corner to (x,v) and the upper right corner to 
itr yi). PNemmOnlymErestrictloms are that the two points 
define a valid cartesian coordinate system and the four 
values are floating point numbers. All addresses and dis- 
placements issued subsequent to a screen() instruction are 
interpreted according to the defined virtual screen. 

The virtual screen is addressed by specifing an xery 
Beerginate with 4 sSstrtxv(x,y) instruction. The specified 
address (x,sy) establishes the current operating point CEO. 
at that address. The COP is initially located at the lower 
left corner of the virtual screen whenever a screen is 


55 





defined. inewmedro = 4s Occasionally modified after certain 
operations are performed as indicated in Anopendix B and in 
the section on display modes. 
There are three modes of addressing the screen; abso- 
lute, indexed and relative. 
1. Absolute Addressing 
In absolute addressing the user specifies a specific 
MocGation on the user-defined screen by issuINg a 
erertxy (x,y). The 'x' and 'v' values estabdlish the location 
eeetne COP. 
2. Indexed Addressing 
To utilize indexed addressing, the user must issue 
an indexli,sxry) instruction. If ‘'i' 18 equal to one, indexed 
Memressiag 1S initiated. Subsequent to this ti1nstruction, 
all addresses specified by the user are i1nteroreted accord= 
ing to the values 'x' and ‘'y!' contained in the last index() 
mest ruction. For example, if a strtxy(10.0,10.0) is tssued 
after an index(1,15.0,20.0) has been issuedr the resulting 
mre 1s (25.0,30.0). 
To deselect indexed addressing it 1S necessary to 
issue an index() instruction with 't' equal to zero. The x 
and y values, if anyr are ignored and the user 1S returned 
to the absolute addressing mode. 
3. Relative Addressing 
The hardware relative addressing is 1mplemented Dy a 
Smale instruction. Fhe issuing of a pointr(x,y) iInstruc~ 
tion utilizes relative addressing. When issued, the COP is 


calculated by taking the old COP x and y values and summing 
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maem with the pointr() x and y values. For example, if the 
meee 1s (22.0,50.0), and a pointr(30.0,710.9) is issued, 
the new COP becomes (52.0,40.0). Relative addressing is 
omy utilized when a oointr() MNS eruet tom, <1 S issued and 


always refers to the last COP. 


Cee cOviRUL MODES AND CONTROL FLAGS 


The RAMTEK operates tn any one of eight modes. Each 
mode has associated with leEGeGrtainm control flags which 
modify itS operation in the mode selected. Tabdle A-I sum- 
marizes the control modes and control flags and their rela- 
tionshio. 

Control modes are set by issuing a setmode(a,d) instruc: 


myVOn . The value of ‘a' indicates the mode the RAMTEK is to 
beiplaced in. The value of ‘'b' tells the interface whether 


to save the control flags of the orevious mode or not. The 


values of ‘a' and ‘b' that may legally be assigned are sum- 


marized in Aopenadix B. Trewecomtrol modes are as follows: 


A, ALPHANUMERIC DATA MODE 

Alohanumeric Mode is the default mode upon initializa- 
tion of the RAMTEK. All data() instructions issued while in 
this mode are interpreted as oassing alphanumeric data. The 
data 1S processed leftmost byte first and is tnterpreted as 
eight bit extended ASCII character codes. Each received 
Character code is transformed into a dot matrix character 


font which is five real screen elements by seven real screen 
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lines in dimension. fiiemenmsroGceer TOME 1S wien 3 seven 


element by twelve line matrix as illustrated in figure A-e, 


The entire character set is illustrated in reference [2]. 
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Figure Ae-e 
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CONTROL MODES AND CONTROL FLAGS 


Wetinmit1ons . 
I X 
AW 
OW 
FP 
YES 


NO 


Mode 

Name 
Alphanumeric 
Transverse Data 
Raster Data 
Complex Data 
Groahic Vector 
Gramm lear 6 t 
Graphic Cartesian 


Graphic Element 


Indexed Addressing 

Reverse Backaround 

Additive Write 

Double Width 

Fixed Point 

ligg@ucates 9 the ~eontfo! Flag nas 
effect in the Control Mode 
Imcveates the Control Flag coes 
not have effect in the Control! 
Mode 


Control Flags 
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The transmitted ASCII characters are displayed starting 
Seetme COP from left to right on the same line as illustrat= 
ed in figure Awe. If more than 91 characters are written on 
one liner they will] “wrao around" and overwrite on the same 
line. No more than twenty character lines can be displayed 
on the screen. 

Completion of execution of a data() instruction causes a 
"line feed" and “carriage return". Each subseauent data() 
mmstruction wil! disolay on the next alohanumeric line at 
the same starting element as illustrated in figure A-e. The 
new COP after each execution is also illustrated in figure 
Ae-e. 

When the characters are drawn on the RAMTEK screen, the 
Character apoears in the designated color while the rest. of 
meme matrix 1S drawn in the background color. 

Memeo plicablie Control! Flaas 

ae Indexed Addressing Flag 
The effect of indexed addressing is as explained 
above in Virtual Screen Addressing. 
b. Reverse Background Flag 
If set, the character is displayed in the back- 
ground color and the rest of the matrix in the selected 
Selogeas 1)lustrated by the 'Y' in figure Aed. 
ce. Additive Write Flag 
It set, the character is written over whatever 
image happens to be at the same location on the screen. The 
Misemeots the additive write flag is convenient for combining 


characters to create special characters or writ tec 
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Bmaracters close to other images to avoid destroying a por- 
tion of the existing image when aes seven by twelve matrix 
is written. The second apolication is illustrated in figure 
Aes, 
demeeauble Wadth Flag 
If set, causes the displayed characters to be 
mace as wide as normal as illustrated in figure A-4. The 
use of doudle width characters decreases the maximum number 
of characters oer line to 45. 
eee othner Instructions 
See also strout() and lttr() on Aooencix B for addi- 


tional alphanumeric generating capability. 





Effect of Additive Write Flag in Alohanumeric Mode 


Figure A-#-3 
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Effect of Double Width Flag in Alphanumeric Mode 


Figure Aed 


B. TRANSVERSE DATA YODE 

All data() instructions issued in transverse data mode 
are interpreted as passing transverse data. Received data 
omen rittenm im tts raw format, that is, each data byte (oro- 
Sessed leftmost first) is intersreted as a single bit oper 
pixel description of eight consecutive sixels along a par- 
ticular real screen line. As illustrated in figure AsS, 
consecutive data bytes are written from left to right begin- 
ming at the COP and continuing down. All subsequent bytes 
are written beginning at the same element on the next line, 
The COP after the operation is indicated in figure A-S. 

The typical use of transverse data is to define special) 
Symbols and characters which can not be found in the stan- 


Siaed Character set. 
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Dota. seo lovee OODLLOL1OON00L1ON1L0 
133000 LO011011000000000 
000101 0000000001000001 


OLD ae ey 





NEW seh 


Transverse Data Processing 


Figure A#5 


eee oiiecablie Control Flags 
a. Incoexed Acdressing Fiag 
The effect of indexed addressing is as explained 
above in Virtual Screen Addressing. 
6b. Reverse Background Flag 
If set, the data is disolayed as indicated in 
mrouUre A=6. im effect, the comolement of the data is 
displaved. 
Ce DOUD Te Ayath Flag 
MmmsiclurmeedcemrOltn:s tetleceteda in two consecutive 
pixels instead of one, theredy giving an image sixteen pix 
Srcuewidewmimstead of eight. fhe result is tllustrated in 


figure A=-6, 
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d. Additive Write Flag 
It set, the transmitted data is written over 


whatever image haprens to be at tne same location on the 


screen. 
Data: O1svee OO0d0LLO10I00010010 
133000 POT bolic oecu0 odd 
O0O!101 00000000101000001 
\ 
bkrnd(1) 





Effect of Reverse Background and 
Double Nidth Flags on Transverse Data 


Figure A-6 


C. RASTER DATA MODE 
Raster data mode, exceot for the direction of the writ- 
mae process, is identical to ae transverse data mode. As 
illustrated in figure A-7, the consecutive bytes transmitted 
by the data() instruction are written horizontally from left 
to right beginning at the COP. Ay] subsequent oytes are 
f 


written beginning at the next pixel on the same line. The 
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COP after the operation is as merustratequnsin figure  <A=7. 
The contro] flags that apoly to transverse data mode also 


apoly to raster data mode in the same manner. 
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Raster Data Processing 


Figure A-/7 


wee COMPLEX DATA MODE 

This mode 1s used to write data on the screen exactly 
the same way that raster data does. However, a third dimen- 
Sion 1s added in this mode in that each pixel is descrived 
by four bits of the passed data. Therefore, a single data 
word describes four pixels instead of two as in the previous 
data modes. 

The Bene: Samet semode 1S that the color of each pixel 
being passed is defined oy the four bits that are assigned 
to that pixel. fhe four bits reoresent a number from zero 
through fifteen which is used as a pointer into the color 
lookup taole. If the pointer's value is six (0110), the 
color of the pixel will be whatever is indicated in entry 
mxeot the color tabie in use. 

It can be seen that this mode overrides the color desig= 
mated Sy the color() imstruction. Interesting images can de 
achievec by the use of this data mode. A411 flags applicable 
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to raster data are apolicable to comolex data except addio- 
eyve write. Fiqure A#-8 illustrates how a data word is ine 


terpreted in this mode. 


pata word: | 1j1/1]1/4/o/1/o/oj1]4] 1/0] 0} 1/1 ]= 175163 
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Complex Data Processing 


Figure A=-8 


Be GRAPHIC VECTOR MODE 

The araohic vector mode draws JlineS DbDetween arbitrary 
emo Ooints. The starting point is defined by the existing 
Bureor cam be defined by issuing a strtxy() to estadlish the 
new COP. The end point can be defined by issuing either a 
Meco ommstructiom or a ccint(}) instruction. Tre firse 
uses relative aadressing and the second uses absolute or 
indexed depending upon the control fiags' condition. 

auc mmmexGcuLIOMN. Of am iumstruction, the COP is then the 
ega OOInt of the vector just drawn, iene formes. aides 4 iacedc 
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line, as illustrated in figure A=#9, can be drawn by issuing 
peeaitrtxy() followed by successive ooint() or pointr() ine 


Structions. 


PusumiuG atoms. osetmode (4,0); 
Smuey uel, 10.0); 
Bovgtes.0, 6.0); 
Sonmecne.0,9.0); 
Sovmcmont.0,e.0) 7 


(41.0, 11.0) 





(5.0.8.0) (12.0,9.0) 


Drawing Vectors in Graphic Vector Mcde 


Poguire =o 


ime epolicable Control Flags 
@e Indexed Addressing Flag 
The effect of indexed addressing is as explained 
above in Virtual Screen Addressing. 
Db. Reverse Background Flag 
If set, the lines are drawn in the background 
Eelor. 
Snes ixoornt Flag 
If set, causes the point issued by 4 strtxy() to 
be the starting soint for all subsequent end scoints issued. 
Therefore, the lines are drawn with a common point as illus- 


trated in figure AwW-10. 
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Instructions: setmode(4,0); 
foxotll) >; 
Stet xy (9607, 5.0);7 
Bor me cond, /.0) 7 
Sanne Co. 75.0); 
Soumtrorl.05 1.0) 7 


(8.0.7.0) 


(5.0,5.0) 





(4.0,4.0) 


Orawing Vectors with Fixpoint Flac 


Figure A-10 
meee GRAPHIC PLOT MODE 


The functions performed by the graphic olot mode have 
been implemented as a set of oglot routines in the user ine 
memmace.s. Ine three routines are oplotot(), plotin() ° and 
proth(). 

Ime first OlOtsS a fumetion as 3 Series of points. The 
pecoma, Clors 2 fuUMctton as a continuous line and the third 
EEeoits a fumetion im a histogram style plot. Baen’ ots Othe 
memmods requires the user to ssecify the points to be olot=- 
ted. The three olotting methods are illustrated nm Licure 
Aewtl. Pose Gumaigstruct toms Om their use can be found in 
Appendix 8. It is recommended that these routines de used 
in lieu of the graphic olot mode as they are simpler to use 
and orovide a more powerful caoaodility. However, for the 
ONrogrammer who is interested in using the assemoly l|anquage 
level instructions necessary in this mode, he is referred to 


reference en ae 
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plotpt() plotin({ ) 





- . ploth ( ) 


Plotting Methods 


Figure A-11 


G. GRAPHIC CARTESIAN MODE 

The Graphic cartesian mode draws solid rectangles 
between arbditrary endpoints. The endooints define ogcosite 
corners of a rectangle. The COP is always the Starting 
point of the drawing unless a new COP is Gefined with a 
Strtxy() instruction. The second ooint can be issued with a 
Sore) Of oOlmtrG) instruction. After the ooeration ts 
ocerformed, the new COP is the second point trat was 1sSsued. 

By issuing successive ooints, linked rectangles can ode 
drawn as illustrated in figure Amwled. In this case, the ende- 
Ing pOINt for One rectangle becomes the starting point for 
the next. 
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1. Applicable Control Flags 
ae Indexed Addressing Flag 
The effect of indexed addressing is as explained 
above in Virtual Screen Addressing. 
b. Reverse Background Flag 
[f set, the rectangles are drawn in the back= 
eround color. 
Ce Fixed Point Flag 
If set, al] rectangles are drawn with a common 
starting point much in the same way it 18 done in the graph- 
1c vector mode. A strtxy() instruction determines the com- 
mon point, and subsequent point() or pointr() instructions 
determine the rectangles as illustrated tn figure Agled. 
Instructions: setmode(6,0); 
Smee y (b0.0 7,6. 0) 7 
DioimeGuene,a. 0 ls) 47 “draws A. 
SOG, 20s 7/ Graws 8. 
Pico e la, 
Str Gv 0 7G. 0 )) 7 


SOQumrce Uo. 0) 7 Li mamaWwSaie. 
Soimtc1.0,7.0)5 // @Qraws O. 


(13.0, 9.0) 


(5.0.8.0) 


(2.04.6) 





6.0.6.0) \G0.0,6.0) 


Drawing Rectangles WNith and 
Wvenoul fixpoint Flac 


ProuGe ms =) 
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fee GRAPHIC ELEMENT MODE 
The graphic element mode draws a single pixel on the 
Screen as determined by a ooint() instruction or a pointr() 
instruction. After execution, the COP is on the same real 
screen line and one screen element to the right. 
1. Applicable Control Flaas 
ae Indexed Addressing Flag 
The effect of indexed addressing is as explained 
above in Virtual Secreen Addressing. 
b. Reverse Background Flaaq 
If set, the pixels are drawn in the backaqround 
motor . 
Ge Dowo)e wioth Fliag. 
If set, two consecutive pixels on the same line 


are drawn instead of one. 


fev ENG SeOLOR 


As mentioned earlier, all images that are aisplayed on 
the screen are displayed according to an entry in the video 
moomup table which can also be referred to as the color 
lookup table. This section will diseuss how to define 
colors the user desires, load the color lookup table, use 
the special interactive routine to build color tables and 


use the color lookup table in user orograms. 


A. DEFINING COLORS 


The RAMTEK hardware defines colors by combining red, 
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green and blue in varying intensities to produce color. 
Since the color lookup table, from which the CRT receives 
its instructions on how to mix the three colorss stores 
morormaction im digital fornat, the user is limited to 4096 
Besesible color definitions. Simce the table has a finite 
length of sixteen twelve bit entries and only one table can 
be used at any one time, only sixteen colors can be 
displayed at any one time on the screen, It must also be 
keot in mind that entry zero in the table is used as the 
background color that is to be displayed on the screen 
thereby leaving fifteen colors for image drawing. 
; In order to define an entry in the color lookup table, 
1t 1S first important to examine how the color lookup table 
Stores its information. 
1. The Color Lookup Table 

There are sixteen entries in the color lookup table. 
Each entry represents the code for a color ina twelve bit 
word. As illustrated in figure Aw-l3, each word is broken 
Into three, four bit binary numbers which represent the 


intensities of bluer green and red to ce mixed. 





Golor eookus lable Entry Format 


cite a= 175 
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Mamicomconmvemilent to think of the entry in each table 
momom orcered triple: (0-15,0°15,0-15). This can be extend- 
eg into a three-dimensional definition of the color space in 
which the RAMTEK is capable of displaying color. Figure 5 
ieeetne earlier section on Application of Color illustrates 
this concept. The xraxis contains the sixteen possible 
shades of blues the ywaxis contains the sixteen possible 
shades of green and the z-axis contains the sixteen pvossible 
shades of red. By moving within the confines of the cube, 
all 4096 colors are defined, and their relationship to each 
other is illustrated. 

Beeveriminag Color Table Entries 

In order to define an entry in the color lookup 
table, it is necessary to transform from an ordered triple 
to the twelve bit coded form. This is accomplished by a 
special routine called triple(b,g,r). The ordered triple 
mec |Girectlivy corresoonds to the color cube location 
reoresenting the color the user desires. The routine re 
turns the oroperly coded entry for loading jmtone a& color 


table. 


BeeeCOUADING TRE COLOR LOOKUP TABLE 

The RAMTEK interface system oermits the use of eighteen 
separate color tables. The first four tables (0-3) are 
reserved system tables and cannot be modified in any way. 
Some of the other tables already have entries in them for 
the benefit of the user who wishes to use them, and others 
are empty. 

There are three methods of loading a color lookup tabdle 
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in the user's program. Oner the interactive color routine 
will be discussed separately. The other two are discussed 
@eme. the first 1s a method for loading an entire color 
lookup table, and the second is for loading a single entry 
ieee color lookup table. 
Pee toading an Entire Table 

To load a whole color lookup table requires a series 
of operations. First, the user needs to declare a sixteen 
word, linear integer array. Then it 18 necessary to load 
each entry of the array from zero to fifteen with the six- 
teen colors that are desired. In order to accomplish this, 
it is recommended that the triple() routine be used to code 
the ordered triples and then assign the returned codes to 
each entry tn the array. 

After the array has been loaded, it is then entered 
Ime oO the desired Gaol1or ) lookuo tabdle by the routine 


: 1s the number of the 


clrtol (n-sname). The parameter 'n 
color lookup table (4-17) and 'name' is the name of the user 
array which contains the sixteen coded entries to be loaded. 


An examole of the code to load a color table is as 


follows: 
int allo); //deciares sixteen word array. 
aro) == trionleC0,;0,0); VO ReEGQlOr. oe lack. 
all) = triole(15,90,0); VI MCO\GE O1Ue. 
allée) = triole(0,15,0); // color areen. 


eomoveeamtriore (ls,15,15); /7 color white. 
SlemtiolweGsas a), //\oads color lookup table. 
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The color lookup table entries contained in the array ‘a! 
are loaded into color lookup table number five and are then 
ready for use. 
@e Single Entry Loading 
It may, at timess be desirable to load only. one 

entry in a given color lookup table. In order to do so, the 
entry is coded with the triple routine and then loaded in a 
specific table and entry by usSina the chnae(numb-rentry,cont) 
routine. For example, to load the color defined by the 
ordered triple (5,6,10) into entry three of color lookup 
table ten, the following two instructions are issued: 

Comte = terole(5,6,10); 

chnge(10,3,cont); 
If the change takes place in a color lookup table that is 
being used for display, the change is reflected on the 


screen immediately. 


PemeeeNUTERACTIVE COLOR PROGRAM 

The puroose of the interactive program is to allow the 
user to see and modify color lookup tables while seated at 
the RAMTEK keyboard. It 1s recommended that the new user 


sit down at the RAMTEK and execute inter() in order to get 


an introduction to the color generating capabilitiesof the 
RAMTEK. There are two basic modes inoeewn ich the routine 
operates. Eaich so ft these modes has a series of commands 


which the user can execute. Appendix B describes the com- 
mands for each mode in detail in its description of inter(). 
1. Paging Mode 


The paging mode oermits the user to page throuach the 
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eighteen possible color lookup tables. Upon execution of 
inter() the paging mode is automatically entered and a set 
Meeeeutorial instructions are displayed. 
ewe cdi t) Mode 
The routine provides five Separate methods of edit- 
feo 29d modifying color lookup tables and their entries. 
How to use the methods is described in Appendix B in the 
Meiscription of inter(). 
a. Table Assignment 
Table assignment mode allows the uSer to 
copy entries from any table into a designated user table. 
b. Octal Assignment 
Entries in a desiaqnated user taodle can be 
defined by entering an ordered octal triole representing the 
color desired. 
ce Combining Assiqnment 
Entries from two color lookup tables can be 
logically OR'd into a desianated user tadle or two whole 
tables can be OR'd into the user table. 
d. Inverting Tables 
This method permits the user to invert a 
designated table. Entry zero becomes entry fifteen, entry 
one becomes entry fourteen and so on. 
e. Copying Tables 
This method permits the user to make cooies 
of any table in the system into a selected user table. 
Thus, the user can modify a system tabdle without destroying 


it. 
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wee FROGRAMMING WITH COLOR 


iomco lor seonme—mtme oRAMTEK 165 not a difficult process 


once the user understands color lookup tables and their 
entries. As mentionec earlier, the system has capability at 
present of storing uo to erghteen color lookuo tables. 


Tables zero through three are reserved system tables leaving 
tables four through seventeen for the user. The system has 
some preloaded tables which contain a variety of colors that 
the user may find useful. If noty they can be destroyed as 
desired. 

iis 2) Good orectice for the user to design his oepro- 
grams making use of the inter() routine. By placing the 
inter() routine inside a looo, the user can modify the table 
or tables the orogram usSesr run the Program and return, if 
desired, to the inter() routine to chanaqe entries in the 
Soler lookuo tables until the desired colors are achieved. 
The user should then save the codes for future use. 

mscsuimgea colort(n) instruction in the user program 
causes the designated color lookuo tanle to be loaded into 
the RAMTEK hardware video lookup table. All tmaqes are then 
Eeapllavyed rFelative to the colors contained in table ‘n'. In 
order to select a specific color to be used, the color(le) 
Instruction 1s issued. All images drawn subsequent fo Gthivs 
instruction will be drawn with the color contained tn entry 
Zenor the color lookup table last selected. 

For example, suppose color table five was the table the 


user wished to user and it contained the following entries: 


Sniemy zero = black (0,0,0) 
entry one = red CORO 7 oS) 
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Snituryemtwo  - Olue (15,0,0) 

entry three = green (0,15,0) 
miemeTrollowing instructions would display a red rectangle, a 
blue line and a green letter AS Omen oirac Ka Dackoround. 


Emtry zero always contains the background color. 


ealort (5); //\oads color table five. 
Cororcl); //selects entry one (red). 
//draw red rectangle. 
setmode(6,0); //set Graphic Cartesian 
mode. 


Situ ty Coie Vin >. 0)s 
SOvmee wn 0, 10.0) 3 

//draw blue line. 
color(2); //select entry two (blue). 
setmode(4,0),; //set Graphic Vector mode. 
Stirexy i toe, 15.0) 7 
SPOnmtGee sos, 10s.) s 

//draw green letter '‘'A'., 
EQVOR (5S) 7 //select entry three (green). 
setmode(0,0); //set Alphanumeric mode. 
Stimucay( 3000, e9.0)7 
data(letter,1); //letter 1S an array containing 

V7 tnemnsellacode for am ‘A’. 


If at any time a new color table is entered, all exist=- 
ing images will change color to the entries that are in the 
new table. -Also, if at any time an entry in the table being 
used is changed, any image on the screen that was arawn with 
that entry number will change to the new color. If ain the 
preceding example the next instruction loaded a table which 
contained the color white in entries one and two, and obdlue 
in three, the rectangle and line would become white and the 


letter ‘'A' would become blue. 
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Ve. PROGRAMMING THE RAMTEK 


There are two routines which it 1s necessary to place at 
the beginning of any C program which desires to utilize the 
user interface for the RAMTEK. 

The ramtek() routine must be the first call made in the 
user program. Pers heim wig lization routine for the user 
interface and it opens the RAMTEK device and keyboard. 

The erase() routine should follow the ramtek() routine. 
This ensures that any old images on the Screen or in the 
RAMTEK memory will be removed. 

Appendix B contains a complete list of the user routines 
which will relieve the user of a significant amount of pro- 
Gramming effort in many cases. Most user routines return 
negative values for error conditions or if incorrect parame= 
ters are passed. It is therefore advisable to be aware of 
the values and their meanings to aid in debugging programs. 

In order to utilize the interface, the following compile 


command should be issued: 


cc filename o-lr 


ae eo Ve WORDS 

Table A-II contains a list of reserve words. These 
words should not be used for user names in any programs that 
utilize the user interface for the RAMTEK device. Some of 
the words are user interface routine names and others are 


variables and subroutine names in the interface software. 
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ADOFF 
adon 
ALPHA 
axis 
BKON 
BKOFF 
okrnd 
blank 
BLK 
block 
bracket 
bu f f 
Dytecnt 
eC 
chnge 
elrhold 
Evry } 
code 
codeit 
coke 
color 
GO.oFr t 
eolortb} 
comb 
COMMA 
COMPD 
conve 
eon] 
copy 
CR 
data 
datao 
dolwid 
diso 
dumo 
einst 
eoaqdel 
epagec 
epaqe 3 
erase 
Eres 
fixpt 
AL iD 
fname 
fo 


face Ait 


RESERVED WORDS 


a esis 
foon 
getf 
getnum 
GRAPHCRT 
GRAPHELM 
GRAPHVEC 
head 
headotr 
heat 
holdx 
holdy 
index 
inotrs 
instr 
instle-inst80 
ace nm 

gh aaa: 
int60 
itoa 
rxOrr 
IXON 

LCM 
lemhold 
PER 

EEX 

eal 

Ee 

ER 

Ele 

eee 

le 

LTA 

iD 

ret r 

_ xD 
moreinst 
nd0\eni?7 
octo) 
out 
pause 
Oe « 

Sle tpot 
Slot a 

Oo oth 
501m t 
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DOPrnNter 
SroG 
oroce 
procs 
eroc4 
SRoOcs 
ot rout f 
putup 
eotr 
aotr! 
Git 
quest 
ail 
ramtek 
RASTERD 
retchar 
SC1SSOFr 
SCR 
screen 
scroll] 
SDC 0 
setmode 
setuo 
size 
sk1o 
SoC Awe 
St ror 
strtxy 
systo] 
tblwho 
TRANSD 
triple 
uopcnt 
vector 
wait 
WDOFF 
WOON 
writon 
xaxis 
xmin 
xmax 
yaxis 
yaxisf 
ymin 
ymax 





fee ie ome sen INTERFACE ROUTINE DESCRIPTIONS 


This Appendix contains Three roeescriotions “of the user 
interface routines in the format that 1s followed aa the 
documentation of the UNIX operating system in the Naval 


Postgraduate School Computer Laboratory. 
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axis JGaero 1976 axis 


NAME: 
axis 7 draw coordinate axis 

SYNOPSIS: 
axis(x,sy) 
float xr ye? 

DESCRIPTION: 
Draws a Cartesian coordinate Vance ymax 1S com) the 
Screen with center at usersdefined Screen coordinate 
(x77). 


The operation is totally indeovoendent of anys control 
mode issued oreviously. 


The COP is left at (max xevaluery). Normal return is 
Zero. 


PIAGNOSTICS: 
Returned -l indicates no portion of the axis ]1es on 
the user-defined screen. 
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bkrnd Jun 10 1976 bkrnd 


NAME s$ 
bkrnd - chanae reverse background flag 


SYNOPSIS: 
bkrnd(a) 
mat as 


DesocRIPTION: 
If aq is zero, the reverse background flag in the con- 
Erolemmoage 1S Set to zero, 1.e@. turned off. 


lf aq is equal to one, the reverse background flaq in 
GRemGcomtrol mode 1s set to one, 1.e. turned on. 


Normal return is zero. 


DPEAGNOSTICS: 
Returned -1 indicates the oassed integer q is not 
equal to zero or one. 
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block Sumer o 19716 


NAME: 
Slock =draw solid block 


SYNOPSIS: 
mloecKk(xl,yl,xeryc) 
float xlr,yl,x2,ye; 


PeoekIPTiIONs: 


block 


A solid block iS drawn with opposite corners as deo 


fined by user-defined screen coordinates (xl,yl) 


(xe,ye). 


and 


trem cOP 1s left at (xe,yec). The operation 1S indepen- 
dent of any mode issued previously but is sensitive to 


all flags apolicable to Graphic Cartesian mode. 


Normal return 18 zero. 


DIAGNOSTICS: 


Returned -o-1l indicates the block can not be drawn on 


the userwdefined screen. 


Bee ALSO: 
index(), okrnd(), dolwid() 
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chnge stineer oO 1976 chnage 
NAME: 
Gnmce w= change color table entry 
SYNOPSIS: 
chnge(numbd-ventry-,cont) 
iatenumo, emtry, cont; 
DESeRIPTION: 
Changes the specified entry lO thes imci cated color 
table to the passed voarameter cont. triple() should 
Semuisedeto Out comt imto the orooer form. 
numb 1s the table number in which the entry is to be 
changed. entry is the entry number to be changed. 


cont is the integer twelve bit code which is loaded in 


the specified entry. 


Normal return 1S 2er0. 


Pao NnoSsticss: 


All errors are indicated by negative returned values. 
The error values and-‘their meanings are as follows: 


=k Indicates numb is less than four or greater 
seventeen. 


-2 - Indicates entry 1S negative or greater than 
teen. 
SEE ALSO: 
triple() 
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elrto! | Jun 10 1976 Galante! 


NAME: 
Girtol ="joeo collom table 
SYNOPSIS: 
clrtbl €ns,name) 
int NM, *name, 
DeeeerRIPTION: 
Loads color table number n with the codes contained in 
the array pointed to dy Name; 


The array 18 an integer array containing sixteen ine 
tegers which reoresent the octal code of the color 
table entries between zero and sixteen. The array 1s 
assumed to be declared sixteen words in length. 


nm is an integer value which ranges from four to seven= 
teen. 


The color tables from zero to four are system defined 
eaples. J Ihey contain the followina: 

Table 0 = Fifteen shades of grey. 

Table 1 - Fifteen shades of blue. 

Table 2 = Fifteen shades of green. 
Table 3 - Fifteen shades of red. 


If the user desires to modify aesystem tadle see 
inter(). 


/ Normal return is zero. 


DEAGNOSTICS: 
Returned -l indicates the passed integer n is less 
than four or areater than seventeen, 


SEE ALSO: 
triple() 
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vum 10 1976 color 


color = select color 


SysiOPSIS: 


co1orl(s) 
Int Ss; 


DESCRIPTION: 


The passed integer s is the number of the entry in the 
Gurreent color table. tme eo lor located im that entry 
will be used for al} SudSeaquent entities disolayed 
ipcyimemwarrrerent color 1S issued. 


§ 1S between zero and fifteen. 


Normal return 318 2er0, 


DIAGNOSTICS: 


Returned 7-1 indicates the oassed integer s 1S negative 
or greater than fifteen. 


Been oO : 


chnge() 
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eorort vum 10 1976 €olort 


NAME: 
colort - select display color table 
SYNOPSIS: 
ecolorte (t) 
iat ts 
DESCRIPTION: 
The passed parameter tt is the number of the color 
table that 1s sent to the ramtek device for display. 
t 1S between zero and seventeen. 
Normal return is zero. 
DIAGNOSTICS: 
Returned -l1 indicates the passed integer t 1S negative 
or greater than seventeen. 
SeeealsSO: 


eveto! ©) 
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data tum 1o 1976 data 


NAME: 
data - display raw data 
megeols: 
data(name,|]) 
int *name, |, 
DESCRIPTION: 
linen aw Gata Oassed im the !}inear array Pointed to by 
name 1S displayed on the ramtek aCCOrQIAG to tne 
current control mode. 
eevouwthe length of the array in bytes! 
Normal return 1s zero. 
DIAGNOSTICS: 
Returned =! indicates the passed integer |] is negative 
Om zero .« 
SEE ALSO: 


Stecoutt), ittrt) 
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dbolwid sic) Os 76 dolwid 
NAME ¢ 
dolwid = change double width flag 
SYNOPSIS: 
Solwid(x ) 
TOt x? 
DESCRIPTION: 
If x is eaual to zero, the double width flag in the 
Somtro!| mode 1s set to zero, 1.e. turned off. 
If x is equal to oner the doudle width fiac! “aoe 
control mode is set to one, i.e. turned on. 
Normal return is 2e°ro0. 
DIAGNOSTICS: 
Peturned -1 indicates the passed integer x 18 not 
equal to zero or one. 
SEE ALSO: 
size() 
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erase Jum 1976 erase 


NAME: 
erase = erases the screen 


SrvorPsis: 
erase() 


DESCRIPTION: 
The ramtek screen is erased to the background color of 
the color table currently being used. 


val 





Pi xpt 


NAME 3 


Jun 10 1976 <3 x0€ 


fmixot = chance fixed point flag in control mode 


SYNOPSIS: 


fama t (x ) 
wrt x; 


DESCRIPTION: 


ret x 1S equal to zero, the fixed point flag in the 
contro] mode is set to zero, i.e. turned off. 


iemxnis ecual to ome, the fixed coint flag in the con- 
Urol mode is set to one, 1.@. turned on. 


Meaningful only in Graphic Vector or Graphic Plot 
mode. In Graohic Vector mode it causes all subsequent 
vectors to be drawn with one end at the same point as 
issued by a subsequent or last previous strtxy(). See 
the user's manual fon tixot()°s meaning in Graghic 
alone 


Normal return 1s zero. 


DIAGNOSTICS: 


Returned ol indicates the passed integer x is not 
equal to zero or one. 
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getf Jun 10 1976 getf 


NAME; 
Getf - read floating ooint number from ramtek keyboard 
SYNOPSIS: 
getf() 
Messer IPTION: 
Returns a floating point number from the pramtek key= 
board. The only numbers recognized are: an optional 
minus sian followed by a string of digits optionally 
containing one decimal points then followed ootionally 
by the letter ‘e' followed by a signed integer. 
Normal return is the floating point number. 
SeeALSO: 


qgetnum(), retchar() 
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getnum 


NAME>: 


SrTNOPS 


DESCR I 


Cun cel 276 getnum 


getnum = read number from ramtek keyboard 


ES: 
getnum(base) 
int base; 


mal ON s 

Returns a positive or negative integer number from the 
ramtek keyboard. Numerals tyoed up to a comma or a c/r 
on the keyboard are consigered to be the number. The 
routine will not return any value until a c/r or a 
comma is tyoedr nor will it accept characters other 
than diaits from zero to nine when base is equal to 
ten, or digits from zero to seven in case of base 
eight. 


base is the base of the integer number returned. Lit 
liscmGestrietead to eignt Coctal) or ten (decimal). 


Normal return 1s the jinteaer number. 


DIAGNOSTICS: 


All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 


=} Imaicates a c7r was struck without any previous 
entries. 


-C Indicates the passed oarameter base was not equal 
te e19nt or ten. 


See ALSO: 


retchar(), getf() 
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index cum Onl o7 6 Index 


NAME: 
Index = select indexing 


SYNOPSIS: 
index(Ci,x,y) 
float xs ys 


Int a7 

DescrRiPT ION: 
Tf 3% equals zero,r indexing is deselected and the ine 
dexing fiag in the control mode is turned off. The 


Index registers are then loaded with zero. 


If 3} equals oner indexina is selected and the indexing 
flags im the controt mode 1s turned on. The index 
registers are then loaded with the displacements 
passed in x and y. x 1§ loaded 1n the xeindex regise- 
ter and y 1s loaded in the yrindex register. 


x must be No greater than the user-defined screen 
Wegit h< y must be no aqgreater than the usersdefined 
screen height. 


Normal return 1S z2era. 


DIAGNOSTICS: 
All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 


=| Indicates the passed integer 1 1S not equal to 
zero or one. 


-2 Indicates one of the passed disnolacements x and y 
iS greater than the screen height or width. 


See ALSO: 
screen() 
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inter 


NAME: 


Jun 10 1976 inter 


inter *= interactive color table modification routine 


omer Sls: 


inter() 


DESCRIPTION: 


Sets up and runs a tutorial program that enables the 
user to look at, select and modify color tables during 
ODrogram execution. There are two basic modes in which 
the routine operates. Each of these modes has a 
series of commands which the user can execute. 


1. Paging Mode. Upon execution the paging mode is 
immediately entered and a set o f InASstructions 1s 
displayed. The following commands are then acceote- 
able: 


poms imaveates  auoarticular table number 1S to be 
displayed. The number must then be entered 
between zero and seventeen. 


n' = Increments table number displayed by one. 
'b' = Decrements table number displayed by one. 
Pano TSO lays ymsct ructions. 
q' = Quits from the interactive routine. 
- Enters the edit mode. 


eC. Edit Mode. When the edit mode is entereds, a set 
of instructions is displaved Jisting the commands that 
cam be issued and the edit method they initiate. The 
commands ares 


't' = Enters table assignment method. Permits 
entries from any table to be copied into the 
table designated by the user. The table 
Number which Wsee to receive the copied en=- 
tries must be entered first. 


'o' = Enters octal assignment method. Entries are 
specified in a designated table by entering 
the ordered triple that defines the color 
desired. The table number (4-17) in which 
the entries are to be defined must be en- 
tered first. 


c' = Enters combining assignment method. This 
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inter 


Smet O 1976 inter 


method allows the user to logically OR two 
separate color lookup table entries into a 
selected user table entry. Whole tables may 
also be combined into a selected user table. 
The user table number (4-17) must be entered 
first. 


'f' = Enters inverting tables method. This methog 
inverts the user table designated by the 
user. Entry zero becomes fifteen, entry one 
becomes fourteen, etc. The act of entering 
the user table number executes the inverse 
i evale 


m' = Enters copying tables method. After entry 
of the user table number that is to receive 
a copied table the number of the table to be 
copied is entered. The act of entering the 
second table number causes the copy to take 
place. 


Upon entry, the editing methods display a les: ft 
instructions on how the method is to be used and the 
results obtained. Each of the methods have commands 
that may be issued. . The legal commands for each edit 
method are summarized below. 


- Table Assignment Method. 
"n' = Indicates the table number and entry 
touwoe Ccooredq f60!1 lows. 
'c/r'eIncrements through the entries 


in the receiving user table. 


9' - Disolays the color lookuo table bee 
modified. To return from the dis- 
Dlay, type a ‘'q'. 

'qg’' - Quits back to edit mode instructions. 


- Qctal Assignment Method. 

‘nh' |= Indicates the octal triple to be en- 
tered as the entry follows. 

'c/r'eIncrements through the entries 
in the receiving user table. 

'p' - Displays the color lookuo table be- 
imag modified. fo return from the 
auseileyv,atvyoe aa . 

qg' = Quits back to edit mode instructions. 
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ite ec Jun 10 1976 inter 


- Combining Assianment Method. 
'n' = Indicates the two ordered pairs 
designatina the table number and 
Satry mumoer to oe OR dG are to fol- 
low. 
"e/r'=-Increments through the entries in 
the receiving user table. 
- Displays the color lookup table 
BeImag moarfited. lo fFetuens trom 
the display, type a 'aq', 
'w' = Indicates two whole tables are to 
be combined (OR'd) and their num 
Dems sdikem toto) |ow. 
Ge = wauy tSGubogek ste edit mode jInstructions. 


p 


- Inverting Tables Method. 
[eo merco lays tmercolor lookup table that 
1S being or was inverted. 
'q' = Quits back to edit mode instructions. 
- Copying Tables Method. 
'p' =- Displays the receiving table. 
[oom dunesemackemto edit mode imstructions. 
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ccc Jun 10 1976 eta 
NAME: 
Ittr = display single character 
SYNOPSIS: 
lee (ehs,si ze) 
int ch, size; 
DeaeriPTlONs: 


Will display the character passed with the size indi-~ 
cated at the current operating point. 


After display, the current operating point is on the 
same line and seven actual screen elements to the 
miamt Of  1tS last position. 


Gnmeconmtalns the ascii code for the character to be 
disolayed. 


If size is equal to one, the character is disolayed in 
standard size. 


If size is equal to twor the character 18 displayed in 
double width size. 


The operation is indeoendent of any mode issued orevi- 
ously, but 1S sensitive to the flags applicable to 
Alphanumeric mode, 


Normal return 1s zero. 


DIAGNOSTICS: 


Returned -1 indicates the oassed integer size was not 
equal to one or two. 


SEE 4050; 


Strout(), data(), size(), index({), bkrnd()s, writon() 


io 





ploth WU iecs 97 6 Sletn 


NAME: 

Slotnm = plot data as a histogram 
SYNOPSIS: 

ploth(x,y,n,odase) 

float *x, *y, base, 

Tre Ae 
DESCRIPTION: 


The values ylil] are assumed to be functions of x{li]. 
As the function is plotted, the area between the curve 
and the x*axis, as desiaqnated by base, is filled in 
with the color last selected. 


That portion of the histogram that lies on the screen 
will be olotted. 


The operation is totally tndependent of any control 
mode issued oreviously. 


x and y are pointers to linear arrays. 
Nn 1s the number of ooints to be plotted. 


Normal return 1S zero. 

PTAGNOSTICS: 
Al) errors are indicated by negative returned values. 
The error values and their meanings are as follows: 
Returned el indicates the passed parameter base 15 not 


on the userwedefined screen. 


SEE ALSO: 
Silatiimtd, olotot () 
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Olotin JiGnee On 1o7 6G plotln 


NAME: 

Dlotin = plot data with connected lines 
SYNOPSIS: 

Sino cmt x,y, n) 

float *x, *y-; 

int Nn, 
DESCRIPTIONS: 


-. The values ylil are assumed to be functions of Coli tue 
As the function is olotted, the successive points are 
connected by straight lines of the color last select 
ed. 


Hhat cortion of the plotted curve which lies on the 
screen will] be plotted. 


The operation is totally independent of any contro] 
mode issued previously. 


x and y are pointers to linear arrayS.e 
ais tne mumoer of ocoints to be plotted. 


SEE ALSO: 
prount), plotot () 


os 





prretot 


NAME: 


Jum ero 1976 Dio tot 


Plot e ec = ollot data with points 


evar Ssis: 


plotptl(xsyrn) 
float *x, *y; 
int ns 


eeoerlPTION: 


The values of ylij are assumed to be functions of 
x fi). iaemtumetion 1S Plotted with dots for each 
(x lilyytil) coordinate. The dots are the color last 
selected. 


If a point does not lie on the users=defined screen, it 
fsamot Dliotted. 


The operation 1s totally independent of any contro!) 
mode issued previously. 


x and y are pointers to linear arrays. 
nm is the number of points to be plotted. 


SeEe ALGO: 


Sloth iG), elotin() 


82 





point Jom Loe lo976 point 


NAME: 
BoMwmt “= define ooint 

SYNOPSIS: 
Bont (xX, y) 
float Xs Yr 

DESCRIPTION: 
Defines a point on the useredefined screen. The point 
must lie within the usersdefined screen. 
If in Graphic Vector modes, (xry) defines the endpoint 
of a vector and causes it to be drawn. The current 
ooerating point is then (xry). 
If in the Graphic Element moder (xry) defines a single 
point on the user-defined screen and causes a dot to 
Demagrawm tnere. ithe current ooerating point 1S then 
(xry). 
Normal return is 26r0. 

Pie NnGSTICS: 
Returned -l indicates the passed ooint does not lie on 
the usersdefined screen. 

SEE ALSO: 


strtxy() 


Sp 





Bointr 


NAME: 


SYNOPS 


Diao | 


Gum O el a7o Somer 


SOimtr = cefine a Point relative 


Ss 
pointr(x,y) 
float x, y? 


eaeLON ¢ 
Defines a point on the user-defined screen relative to 
the last current operating point. 


If in Graphic Vector mode a vector from the _ last 
current operating ooint to a voint defined by the last 
current opneratina point plus the displacements x and y 
1S drawn. 


If in Graphic Element mode a dot is drawn at a point 
defined by the last current operating point plus the 
displacements x and y. 


The COP is left at the calculatea Noeat lone 


SEE ALSO: 


strtxy() 
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ramtek 


NAME: 
ramtek 


SYNOPSIS: 
ramtek 


PeoecRIPTIONs 


Juma ro 1976 ramtek 


- initiates ramtek system 


() 


Initiates the ramtek system ano sets the default cone 
ditions as follows: 


j - 


pe 

US 

ee 

5) = 

Normal 
PUAGNOSTICS: 


Initialize the user=defined screen to 0.0 to 
PO0,0 “in x and y. 

Loads a shades of grey color table (0) tn the 
ramtek. 

Selects color fifteen in table zero for display. 
Selects Alphanumeric control mode. 

Opens the ramtek for reading and writing. 


return 1$ zero. 


Returned -1 indicates ramtek device could not be 
opened. 
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retchar Jum. 0 1976 retchar 


NAME: 
Boaucoime~ read a character from ramtek keyboard 


SYNOPSIS: 
retchar() 


DESCRIPTION: 
An ascii code reoresenting the typed character is 
returned in the lower half of an integer. 


See ALSO: 
getnum(), getf() 
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Scaime en 


NAME: 


Jin 97 6 Screen 


Screen = define user screen 


SYNOPSIS: 


BESER I 


screen(xi,ylsxesy2) 
float xl, yl, KC, ye; 


PTION: 

Defines a standard cartesian coordinate system of any 
scale for the user. The point (xl,yl) becomes the 
coordinate of the lower left corner of the screen. 
The point (xerye) becomes the coordinate of the upper 
right corner of the screen. 


xl must be strictly less than xe. 
yl must be strictly less than ye. 


All subsequent user coordinates are interpreted ac- 
cording to this userwdefined screen. | 


Normal return iS zero. 


DIAGNOSTICS: 


Returned -1 indicates xl is not less than xe or yl is 
not less than ye. An error message is also printed on 
the terminal screen. 
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scroll 


NAME: 


srNOPSIS: 


DESCRIPTION: 


Jum LO 1976 SEro || 
Scroll = scroll screen 
Berolila,cnt ) 
char as 
fioat cnt; 
The current disolayed picture on the screen 1s 
Seroilled uO OF down. Information scrolled off the top 
of the screen will be scrolled in the bottom and 


vice=versa. 


If a is the character ‘d', the direction of the scroll 
will be down. 


If ais the character ‘u', the direction of the scroll 
will be up. 


ent is the number of user-defined yrunits that the 
picture 18 to be SG co lied. cnt can be no larger than 
the screen height. 


Normal return is zero. 


DIAGNOSTICS: 


All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 


~ |} Indicates the passed parameter cnt was less than 
zero or greater than the screen height. 


-2 Indicates the passed parameter c was not a ‘'d' or 


a 
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setmode Jum 10 1976 setmode 
NAME: 
setmode = select control mode 
SYNOPSIS: 
setmode(a,b) 
Int ar, bo? 
DESCRIPTION: 
Selects the control mode according to the passed 
parameters a and b. ea reoercesemts the Control mode as 
follows: 
Q0 = Alphanumeric 
1 = Transverse Data 
e = Raster Data 
Seemcomolex Data 
4 = Graphic Vector 
5 - Graohic Plot 
6 = Graphic Cartesian 
7 = Graphic Element 
Mieriacgseare turned off 1f b is equal to zero. If ob 
1S equal to one, any flags set in the previous mode 
are also set with the mode selected by a. Ay] enti 
ties displayed subdsequent to this call are displayed 
according to the selected mode. Routines that disre- 
gard the selected node are axis(), block(), inter(), 
Dano} otht(), olotint(), clotot() and vector(). 
Normal return is zero. 


DLAGNOSTICS: 
All errors are indicated by 
The error values and their me 


Indicates the passed 
zero or greater than sev 


a | 


=e 
ZeGO ch One. 


See ALSO: 
ramtek(), 
writon() 


bkrnd(), dolwid(), 


ag 


Indicates the passed parameter 6 was not equal 


negative returned values. 
anings are as follows: 


parameter awas less than 


ene 


te 


fixot(), index(), 





Jun 10 1976 $1ze 


size = select letter size 


size 

NAME: 

Sr GPSIS: 
size(r) 
poe oes 


MeoernlPTION: 


If er is equal to one the 


used. 


If er js eaual to two the 


1s used. 


Sets the 


double width 


Therefore size takes the 


Normal return 18 zero. 


DIAGNOSTICS: 


Returned <1 


equal to one or two. 


Se eA SU: 
dolwid(), 


Stanaqera  charecter $1ze 1s 


double width character $1ze 


flag (ihe hen comt to. mode. 
same action as dblwid(). 


indicates the oassed parameter c is not 


Strout Gi tt r ) 
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strout Jun 10° 1976 Strout 


NAME: 
Toure OucpuUt Character string 


SYNOPSIS: 
Strout (sp) 
char *Sp, 


DeaoriPTIONns: 
Outputs a character string no greater than 100 charac- 
ters long beginnina at the current operating point and 
continuing on the same _ line. After comoletion,s an 
automatic line feed occurs which defines 38 new current 
operating point on the next line at the same starting 
point as the orevious line. 


Sempormts to the character string to be outout. 
Normal return 1S zero. 
DIAGNOSTICS: 
Returned ol indicates the string contained more than 


100 characters. In this case no characters will be 
displayed. 


SEE ALSO: 
Gdarat), size(), Ittr) 
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strtxy Jim o =) 97 6 Strtxy 


NAME: 
Sstrtxy = estad!]ish current operating point 


SYNOPSIS: 
Strtxy(x,y) 
float x, y? 


BeseeiIPTIONs 
Establishes the current operating point on the’ screen 
for subsequent V riSttemulc tO mS « If the current mode is 
Graphic Vector with the fixed point flag set, it es 
tablishes the base from which the vectors are drawn. 


x 18 a usSersdefined screen location In Xe y 1s a 
user-defined screen location in y. 


(x,y) must lie within the useredefined screen. 


Normal return 18 zero. 


DeeGNOSTICS: 
Returned -l1 inagicates (x,ry) does not lie on the user= 
defined screen. 


See .4LSC: 
fieote), sereen(), point () 
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tblwho 


NAME: 


tolwho = request 


SYNOPSIS: 
tolwho() 


DESCRIPTION: 
} Returns an 
the color 
display. 


integer value which 


table 


Jun 


that 


fom 976 


is 


os 


currently 


tolwho 


for current color table number 


is the table number of 


being used for 





triole 


NAME: 


Jun 10 1976 triple 


triple = code color from three number triple 


SYNOPSIS: 


DESCRI 


triplelbsg-r) 
ito, Os fs 


PTIONs 
The three input parameters representing the amounts of 
bliue(b), green(g) and red(r) are coded into an integer 
which 38 suitable for insertion into color table en= 
tries. 


b i$ between 0 and 15 and represents the amount of 
blue desired. 


g 18 between Q and 15 and reoresents the amount of 
qgreen desired. 


ris between 0 and 15 and reoresents the amount of red 
desired, 


Normal return 18 an tnteger representing the code. 


DIAGNOSTICS: 


Returned =] indicates inout Oarameters by, gor r are 
negative or greater than 15. 


SEE ALSO: 


anage(), clrtbi () 
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vector Jun 10 1976 


NAME: 

Vector = draw sinale vector 
oer NOPSi(S: 

vector(xl,ylsxerye) 

float xl, yl, xCy yer 
MeoeRIPTION: 


VC GEO, 


A vector 1S drawn oon the screen from user-defined 


seimeen coordinate (xi,yi) to (xeéesye). 
Seerating Ooint is ieft at (xéryed). 


The operation is independent of any mode 


The current 


issued previ 


ously but 18S sensitive to the flags anponlicable to the 
Graphic Vector control mode. Undesired results may be 
ebtained if the fixot flag is set previous to calling 


vector(). 


Normal return is zero. 


DIAGNOSTICS: 
Returned -1 indicates no portion of the 
lies on the user defined screen. 


Sec ALSO: 
DicEmol, —Obiwid, fixpt(), index () 


-) 


indicated line 





writon TUR 1976 writon 


NAME: 
WrFItTON = additive write 


SYNOPSIS: 
writon(w) 
Int we 


SescrkIPTION: 
If wis a oner the additive write flag in the control 
mode 1S turned on causing ‘subseauent entities a 
Alohanumeric, Raster Data and Transverse Data modes to 
write on top of previous entities without destroying 
them. 


If wis a 2ero,r, the additive write flag in the control 
mode is turned off. 


Normal return 18S 2efro. 


DIAGNOSTICS: 
Returned -l indicates the passed integer w 1S negative 
or greater than one. 
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